home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / gen_bbs / ezylo150.zip / LASTONES.DOC < prev    next >
Text File  |  1996-11-23  |  7KB  |  167 lines
  1.  
  2.                                Lastones v1.5
  3.                     A Last Callers Door for Ezycom BBS's
  4.                            Released: 25-11-1996
  5.  
  6.                     Copyright (c) 1996 by Adam Whitehead
  7.  
  8.                     Written in Borland Turbo Pascal v7.0
  9.                           Using eDOOR comm routines
  10.                                   by Enigma!
  11.  
  12.                                    FREEWARE
  13.  
  14.  
  15. What is Lastones?
  16. ~~~~~~~~~~~~~~~~~
  17. Lastones is a door program designed specifically  for Ezycom-based BBS
  18. systems.  When configured correctly and executed  with the appropriate
  19. command-line  parameters, it will display the current days callers or,
  20. when the /Y parameter is  used, the previous days callers.  This first
  21. public release of  Lastones also  supports the  displaying  of aliases 
  22. rather than the users' real names.
  23.  
  24. I run an Ezycom BBS. How do I install Lastones?
  25. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  26. Installation is very simple. First unpack the contents of the Lastones
  27. archive (EZYLOxxx.ZIP) into a sub-directory off your Ezycom directory.
  28.  
  29.         eg. C:\EZY\DOOR\LAST\
  30.  
  31. [ please note: your EZY environment variable must be set, Lastones uses
  32.   this to find your TODAY.BBS and YESTER.BBS files! ]
  33.  
  34. Now open the configuration file named LASTONES.CFG with a text editor.
  35. Instructions are contained within this  file  and these should  all be
  36. self-explanatory anyway. Once  you  have  configured Lastones, you are
  37. almost ready to go. Now create a batch file like the following to exit
  38. to Lastones when the user on-line presses the appropriate key  to view
  39. a list of today's  callers (or yesterday's callers). Call  this  batch
  40. file LAST.BAT or LO.BAT or something. Example:
  41.  
  42. @ECHO OFF                     ;; This turns off screen echoing.
  43. CLS                           ;; Clears the screen.
  44. CD C:\EZY\DOOR\LAST           ;; Change to the Lastones directory.
  45. LASTONES /N%1 /DC:\EZY %2 %3  ;; This is the hardest part, the
  46.                               ;; switch /N%1 refers to the node number
  47.                               ;; the user is executing Lastones from.
  48.                               ;; %1 just means that whatever the first
  49.                               ;; parameter that was passed on the
  50.                               ;; command-line will be inserted here.
  51.                               ;; (this will be passed to LASTONES by
  52.                               ;; Ezycom with the *N command.)
  53.  
  54.                               ;; /DC:\EZY refers to the path where
  55.                               ;; your dropfile is created when Ezycom
  56.                               ;; exits.. this is usually the main
  57.                               ;; Ezycom system directory.
  58.  
  59.                               ;; %2 and %3 are similar to what I
  60.                               ;; mentioned above. This just means that
  61.                               ;; if /A or /Y are passed from Ezycom,
  62.                               ;; LASTONES will recieve this switch and
  63.                               ;; act accordingly.
  64.  
  65. Once this is done, now you need to load  EzyMenu and create a menu item
  66. to load Lastones. Create a new menu  item, using 'T' as the hot key (if
  67. you want, any key is acceptable). Then under Menu Type choose '7' which
  68. is "Run Program in DOS Shell'.. Now put this in the data field:
  69.  
  70.         *C /C C:\EZY\LAST.BAT *N *M
  71.  
  72. where C:\EZY is your Ezycom directory and LAST.BAT is the name of your
  73. newly created Lastones batch file. *N tells  Ezycom  to  pass the node
  74. number on to Lastones as %1 in the batch file. *M  means  that  Ezycom
  75. will swap itself to memory when Lastones is  executing  to free up  as
  76. much memory as possible.
  77.  
  78. Now the important part.. command-line parameters. If you want Lastones
  79. to display aliases rather than real names in the caller lists, add  /A
  80. to the command-line mentioned above.
  81.  
  82.         eg. *C /C C:\EZY\LAST.BAT *N *M /A
  83.  
  84. Now Lastones will display aliases rather than your  users  real names.
  85.  
  86. You might also want your users to be able to view a list of Yesterdays
  87. callers rather than just Today's callers.  Create  another  menu  item
  88. exactly the same as above using a different hot key. (eg. 'Y') and add
  89. /Y to the command-line.
  90.  
  91.         eg. *C /C C:\EZY\LAST.BAT *N *M /Y
  92.  
  93. This will display a list of Yesterday's callers. You can also have '/A'
  94. on this command-line too, so that Lastones will display the aliases of
  95. Yesterday's callers rather than their real names.
  96.  
  97. Other Stuff
  98. ~~~~~~~~~~~
  99. Lastones should now work fine! If it doesn't and you are really stumped
  100. as to why it isn't working, you can e-mail me at  the address I mention
  101. at the end of the document, and I will assist you as much as I possibly
  102. can. Also, note that if Lastones detects Windows 95, it will change the
  103. title of the VM it's running in to "[ Lastones v1.5 by Adam Whitehead ]"
  104. rather than just LASTONES ( as Windows 95 would usually name it because
  105. of its MS-DOS name ).  This is pretty spiffy stuff! I encourage you  to
  106. use this in your MS-DOS software. First detect  Windows '95  and  if it
  107. is loaded, use function INT 2Fh / AX=168Eh to set the application title.
  108. Look in the MS-DOS Interrupt list for more info on this function!
  109.  
  110. Lastones is fully multitasker-aware.
  111.  
  112. More Stuff
  113. ~~~~~~~~~~
  114. Lastones is freeware. However, if you feel like being nice and you like
  115. the software.. then by all means feel free to send  me a  postcard or a
  116. donation!
  117.  
  118. Please send any postcards or  cash  donations to the following address:
  119.  
  120.                 Adam Whitehead
  121.                 13 Wheal Court Anula,
  122.                 Darwin NT 0812
  123.                 Australia
  124.  
  125. If  you  send  me  a  donation, please  make  sure it is  in Australian
  126. currency!
  127.  
  128. Thank you!
  129.  
  130. Where you can get the latest version
  131. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  132. You can always obtain the latest version of Lastones from:
  133.  
  134.         http://www.stormfront.com.au/~primus
  135.  
  136.         ^ the best place to get Lastones! Latest version always and
  137.           a pretty spiffy homepage too (by me).
  138.  
  139.         ftp.ros.com.au   /pub/ezyutils/ezyloXXX.zip
  140.  
  141.         or any of the SimTel mirror sites
  142.         in the directory
  143.  
  144.         /(simtel mirror dir)/msdos/bbsdoors/ezyloXXX.zip
  145.  
  146.         (where XXX is the version number)
  147.  
  148. or by calling my BBS, the Elysian Fields!
  149.  
  150. How to contact me
  151. ~~~~~~~~~~~~~~~~~
  152. Please report any bugs to me straight away!
  153.  
  154. You can contact me in the following ways:
  155.  
  156.         Internet E-mail : primus@stormfront.com.au (preferred)
  157.                         : spatula@hotmail.com (definitely not preferred =)
  158.  
  159.                     BBS : The Elysian Fields
  160.                           +61-8-8927-2965
  161.                           (Within Aus. (08) 8927-2965)
  162.  
  163. Thanks!
  164. Adam Whitehead, [ Author of Lastones ]
  165.  
  166. [eof]
  167.